home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / bin / tiepoint.README < prev    next >
Text File  |  1994-08-01  |  6KB  |  141 lines
  1.  
  2.                              tiepoint README
  3.  
  4.  
  5. To give this program a try - type 
  6.  
  7. tiepoint -r ../src/haeberli/images/jeff.rgb ../src/haeberli/images/dave.rgb
  8.  
  9.  
  10.  
  11.      tiepoint(1)       UNIX System V (30 June 1991)
  12.  
  13.  
  14.      NAME
  15.       tiepoint - Demonstration of Warping and Registration by
  16.       Specifying Tie Points
  17.  
  18.      SYNOPSIS
  19.       tiepoint [ options ] img-file
  20.  
  21.           where    the options are:
  22.  
  23.       [ -order ][ -s scale ][ -r ref-file ][ -v vec-file ]
  24.  
  25.      DESCRIPTION
  26.       This program demonstrates the    use of Control or Tie points
  27.       to determine the coefficients    of a polynomial    warping
  28.       function.  An    original image is displayed in one window, and
  29.       the warped image in another.    A reference image or vector
  30.       overlay may be specified to help guide the warping.  A pop
  31.       up menu provides additional controls.
  32.  
  33.       The orderr option specifies the order of the warping
  34.       polynomial, and must be between 1 and    3.  It defaults    to 2.
  35.  
  36.       The scale factor scales the output window by the specified
  37.       value.  The output window may    also be    resized.
  38.  
  39.       The ref-file is the name of a    reference image    on top of
  40.       which    the warped image will be displayed.
  41.  
  42.       The vec-file is the name of an optional file of vectors to
  43.       be displayed over the    image.
  44.  
  45.       The img-file is the name of the original image and defaults
  46.       to snap.rgb.
  47.  
  48.      WARP CONTROL
  49.       Tie points can be added by pointing to either    image,
  50.       clicking the left mouse and dragging to locate the desired
  51.       new location.     Tie points are    indicated by a yellow line
  52.       with a small circle at the destination end. They are shown
  53.       in both windows, and move during editing. Pointing and
  54.       clicking on an existing small    circle will edit its
  55.       placement.
  56.  
  57.       An additional    point is shown for each    tie point to indicate
  58.       where    the point will actually    reside given the current set
  59.       of constraints.  It is connected to the end points of    the
  60.       requested tie    points with red    and cyan lines.    It appears
  61.       only momentarily on the output image,    and moves during
  62.       editing.
  63.  
  64.       The Tie Pt Control menu has selections to clear all tie
  65.       points, to delete the    last tie point selected    (backspace
  66.       also deletes the last    tie point), or to save or restore the
  67.       tie points in    a file warped.tiepts. The tie point values are
  68.       scaled to 0:1.
  69.  
  70.       Meshes are shown on each image to indicate the effect    of the
  71.       current editing.  The    mesh on    the input image    outlines the
  72.       area which will be sampled to    form the output    image.    The
  73.       mesh on the output image outlines where the original image
  74.       will go.  The    meshes can be disabled or enabled via the
  75.       Overlay Control menu.  The display of the overlay vec-file,
  76.       if supplied, may be hidden via this menu.
  77.  
  78.       All tie points and meshes can    be removed for viewing via the
  79.       Clear    Notations selection of the Overlay Control menu.
  80.  
  81.       The Resamplers menu allows selection of Nearest Neighbor,
  82.       Bilinear, or Bicubic interpolation to    produce    new pixel
  83.       intensities from the original    image pixels.  The complexity
  84.       of the interpolation increases in that order.
  85.  
  86.       The order of the warping polynomial can be set to a first,
  87.       second, or third degree polynomial via the Warp Order menu.
  88.       A first degree polynomial requires at    least 3    points,    a
  89.       second order requires    at least 6 points, and a third order
  90.       requires at least 10 points.    It is a    good idea with the
  91.       higher orders    to choose stationary points randomly
  92.       distributed over the image as    the initial set    of tie points,
  93.       as the mapping is very sensitive.
  94.  
  95.       The warped image may be written as a sgi image file to the
  96.       file named warped.rgb via a selection in the main menu.
  97.  
  98.      REGISTRATION
  99.       An image may be registered to    either a reference image or to
  100.       a vector overlay.  If    a ref-file is given, it will determine
  101.       the shape of the output window and the input image will be
  102.       scaled to match.  The    window may be resized and will retain
  103.       the proportions of the reference image.  Initially, only the
  104.       reference image will be shown.  When a sufficient number of
  105.       tie points have been chosen to determine the warping
  106.       polynomial, the warped image will be displayed on top    of the
  107.       reference image and will be surrounded by a border.
  108.  
  109.       Clicking and dragging    on the middle mouse button near    a
  110.       border will move the border to reveal    the reference image.
  111.  
  112.       Additional menu selections in    the Image Control menu provide
  113.       for showing no output    image, a transparent output image, the
  114.       difference between the output    and reference images, or a two
  115.       tone image with the output in    cyan and the reference in red,
  116.       or the other way around.  The    difference and two tone    images
  117.       are useful in    registering two    similar    images,    while the
  118.       normal and transparent output    are useful in registering an
  119.       image    to a map.
  120.  
  121.       The vec-file is an ascii file    with one x y point per line
  122.       and the last point of    a line segment distinguished by    the
  123.       presence of a    third field.  The values are pixel coordinates
  124.       and should match the size of the reference image, if
  125.       present, or the input    image if not.
  126.  
  127.      NOTES
  128.       Experimenting    with the first order mapping may help in
  129.       understanding    how the    tie points effect the mapping, and
  130.       what the notations mean.  The    output image can be disabled
  131.       via the Image    Control    menu to    allow the mesh of the output
  132.       image    to be manipulated more rapidly,    then re-enabled    to see
  133.       the result.  Although    the input mesh is reasonably well
  134.       behaved, it does wrap    over itself at times, producing
  135.       multiple copies of the overlapped region in the output
  136.       image. The output mesh is therefore a    multiple valued
  137.       function, even undefined for those parts of the input    image
  138.       which    are not    sampled    by the input mesh, and hence looses
  139.       its accuracy when this occurs.
  140.  
  141.